home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP Products & Services 1994 Summer / NeXTSTEP Products & Services 1994 Summer.iso / AlembicDemo.app / Cub'X-Window / InstallationREADME.rtf < prev   
Text File  |  1994-03-17  |  9KB  |  197 lines

  1. CUB'X-WINDOW DEMO VERSION
  2.  
  3. CubXDemo.pkg : 2.7 Mb compressed, 4.4 Mb installed.
  4.  
  5.  
  6. THIS IS A DEMO VERSION OF Cub'X-Window v 4.4.
  7.  
  8. Cub'X-Window demo version 4.4 presents 2 packages :
  9. - CubXWindowDemo.pkg is the package to use if you want to install the demo version on NeXT hardware.
  10. - CubXWindowDemoIntel.pkg is the package you must use if you want to install the demo version on Intel based platforms.
  11.  
  12. Cub'X-Window DEMO VERSION QUITS AFTER HAVING PERFORMED A SPECIFIC NUMBER OF EVENTS.
  13. Cub'X-Window Demo Version includes a limited number of user applications and fonts, but presents all functionalities and X display options you can access in Cub'X-Window. 
  14. Although Cub'x-Window Demo Version does not include the User Guide, all Cub'X-Window functionalities are explained in the On Line Help.
  15.  
  16.  
  17. 1.    Installation Process
  18.         Before installing Cub'X-Window 
  19.         1    Installing Cub'X-Window packages
  20.         2    Building the X Window System
  21.         3    Installing your X Window System default user environment
  22.         4     Installation Process, Troubleshooting
  23.  
  24. 2.    De-installing Cub'X-Window 
  25.         1    Unbuilding Cub'X-Window
  26.         2    Deleting Cub'X-Window packages
  27.         3    Removing CubXWindow and CubXWindow.app directories
  28.  
  29.  
  30. 1.    Cub'X-Window Installation Process
  31. __________________________________________________
  32.  
  33. Cub'X-Window Demo version installation process goes through 3 stages, to be followed specifically from stage 1 to stage 3. 
  34.  
  35. Stage 1        Installing the CubXWindowDemo or CubXWindowDemoIntel package
  36.  
  37. Stage 2         Building the X Window System
  38.  
  39. Stage 3         Installing the X default user environment
  40.  
  41. Cub'X-Window Demo version is provided in NeXT package format, and is installed with NeXT Installer application.  To know more about NeXT Installer, please read in NeXT User's Reference chapter "Managing Installer Packages : Installer".
  42.  
  43.  
  44. Before installing Cub'X-Window 
  45. __________________________________________________
  46.  
  47. 1.    Check NeXTSTEP version number.
  48. Cub'X-Window Demo version 4.4 runs on NEXTSTEP v3.x.  
  49.     
  50. 2.    Check if another X Window System is already installed on the computer.
  51. If another X server is already installed on the computer, Cub'X-Window will refuse to be installed.  Since all X servers use files with the same name, installing 2 X 
  52. servers on the same computer could lead indeed to malfunctions in both X servers. We recommend that you de-install the other X Server before installing Cub'X-Widow. 
  53. If you wish to run 2 X servers simultaneously, Cub'X-Window provides this option. 
  54.  
  55. 1.1    Installing CubXWindowDemo package
  56. __________________________________________________
  57.  
  58. 1.  Log in as root to have superuser status.   
  59. 2.  List in the Workspace the CD-ROM content, and double-click on CubXWindowDemo.pkg (CubXWindowDemoIntel.pkg).  
  60. 3.  Click on Install in the Installer window.  
  61. 4.  Decide where to install Cub'X-Window on the hard disk.
  62. Cub'X-Window can be installed in the location of your choice. We propose /LocalApps as a convenient installation folder.
  63. 5.  Close NeXT Installer when the installation process is completed.   
  64.  
  65. Once the files of CubXWindowDemo package are installed, Cub'X-Window presents 2 items in the installation folder :
  66.     • CubXWindow.app        : Program launching Cub'X-Window.
  67.     • CubXWindowInstaller.app    : Program containing all X files.
  68.  
  69. 1.2    Building the X Window System
  70. __________________________________________________
  71.  
  72. After installing the package, all files needed for X are located in CubXWindowInstaller.app program.  For X to run properly, symbolic links must be created from these files to specific locations, and additional system configuration files are required. 
  73. The build process configures the proper file environment. 
  74.  
  75. 1.  Log in as root to have superuser status.   
  76. 2.  Double click on CubXWindowInstaller.app icon in the installation folder. 
  77. Cub'X-Window Installer appears.
  78. 3.  Click on Build in the Installer window.  
  79. 4.  Once the building process is completed, save and quit all other applications running on the computer and reboot the computer.
  80.     
  81. NOTE :  If you are not superuser, a message similar to the following appears :  
  82. You must have superuser status to run this application. Please enter root password. 
  83. Enter the root password in the corresponding text field, and click on Login. You can then go back to step 2 of the building process.  If the password you entered is wrong, the panel will keep appearing.
  84.  
  85. IMPORTANT :If you move Cub'X-Window programs (CubXWindow.app and CubXWindowInstaller.app) to another location, you need to unbuild Cub'X-Window before moving the programs, and rebuild Cub'X-Window after having moved the programs.
  86.  
  87.  
  88. 1.3 Installing your X user environment
  89. __________________________________________________
  90.  
  91. When building the X Window System,  the installation process copies a default environment into /usr/template/user.  New users created on this computer will automatically inherit the default X environment.
  92. The following operation duplicates this X default environment into the user directory.
  93.     
  94. 1.  Log in as yourself.   
  95. 2.  Launch Terminal.app located in /NextApps.   
  96. 3.  In the Terminal window, type :     /usr/bin/X11/installX   
  97. 4.  At the prompt :  overwrite .cshrc? 
  98.  
  99. If you or your system administrator never modified the .cshrc file in your home 
  100. directory, you     can overwrite the .cshrc file.
  101. Type "y" to answer yes:    overwrite .cshrc? y
  102.  
  103. If the .cshrc file has been modified, please contact your system administrator, or 
  104. follow the instructions below in order not to overwrite your own version of .cshrc 
  105. file :
  106. 1.     Open your .cshrc file.
  107. 2.     Add /usr/bin/X11 in your PATH environment variable, by typing the following line in your .cshrc file :
  108. set path=( $path  /usr/bin/X11)
  109. 3.    Set the variable DISPLAY to unix:0 and export it if necessary.
  110. Type the following line in your .cshrc file :
  111. setenv DISPLAY unix:0
  112. 4.    Save the modified .cshrc file.
  113.  
  114. NOTE : When overwriting the .cshrc file, the installation process makes a copy of the previous version of .cshrc before replacing it by the Cub'X-Window version. This backup copy is named.cshrc.old, and is located in usr/template/user.
  115.  
  116.  
  117. 1.4    Installation Process, Troubleshooting
  118. __________________________________________________
  119.  
  120.  
  121.  
  122. 1    Cub'X-Window quits just after launching.
  123. __________________________________________________
  124.  
  125. Problem:    When launching Cub'X-Window, a gray X background appears, and suddenly quits to go back to NeXTSTEP background.
  126.  
  127. Cause:         The X environment is not installed in the user directory.
  128.  
  129. Answer :    You must install the X environment in the user directory : 
  130.         Follow the installation process starting 1.2
  131.  
  132.  
  133. 2    Unexpected questions when entering the installX command
  134. __________________________________________________
  135.  
  136. Problem:     When installing the X environment by typing /usr/bin/X11/installX in a Terminal application, unexpected questions appear such as below :
  137.     
  138.         overwrite /me/.xinitrc? 
  139.         overwrite /me/.twmrc? 
  140.         overwrite /me/.Xdefaults? 
  141.         overwrite /me/.CubXLauncher? 
  142.     
  143. Cause:         A X user environment has already been installed in the user home directory.
  144.  
  145. Answer:        - Cub'X-Window has already been installed : you can overwrite the files. They will be replaced by the new Cub'X-Window files.
  146.  
  147.         - Another X server has already been installed.  By overwriting the files, note that you you will lost the default environment of the other X server 
  148. package.
  149.  
  150.  
  151. 2 De-installing Cub'X-Window 
  152. __________________________________________________
  153.  
  154. Cub'X-Window de-installation process goes through 3 stages, which must be followed in chronological order. 
  155.  
  156. Stage 1        Unbuilding the X Window System 
  157.  
  158. Stage 2        Deleting the Cub'X-Window Demo Package
  159.  
  160. Stage 3         Removing CubXWindow.app and CubXWindowInstaller.app.
  161.  
  162.  
  163. 2.1    Unbuilding Cub'X-Window
  164. __________________________________________________
  165.  
  166. The unbuild process restores the system to its initial state.  If you remove Cub'X-Window files without previously unbuilding the X Window System, stray symbolic links will remain on your hard disk.
  167.  
  168. 1.  Log in as root to have superuser status.
  169. 2.  Double-click on CubXWindowInstaller.app.  Cub'X-Window Installer window appears.
  170. 3.  Click on Unbuild in the Installer window.
  171. 4.  Close Cub'X-Window Installer when the unbuild process is completed.
  172.  
  173.  
  174. 2.2    Deleting Cub'X-Window Demo package
  175. __________________________________________________
  176.  
  177. 1.  Log in as root to have superuser status.
  178. 2.  Double-click on CubXWindowDemo.pkg located in the directory /NextLibrary/Receipts.
  179. 3.  Click on Delete in NeXT Installer window.
  180. 4.  A message similar to the following appears :
  181.     This action will remove the entire contents of the CubXWindowDemo package from your system. Are you sure you want to delete CubXWindowDemo.pkg?
  182. Click on Delete.
  183. 5.  Close NeXT Installer when deletion process is competed.
  184.  
  185.  
  186. 2.3    Removing CubXWindow.app and CubXWindowInstaller.app
  187. __________________________________________________
  188.  
  189. Once the de-installation process is completed, CubXWindow.app and CubXWindowInstaller.app which remain in the installation folder are empty folders. You can then destroy these empty folders.
  190.  
  191. 1.  Log in as root to have superuser status.
  192. 2.  Select CubXWindow.app and CubXWindowInstaller.app located in the installation folder.
  193. 3.  Choose Destroy in the file menu of the Workspace manager.
  194. 4.  Answer Yes in confirmation panel.
  195.  
  196.  
  197.